home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Utilities / Ph 1.1.1 / Lib / utl.h < prev    next >
Encoding:
C/C++ Source or Header  |  1991-12-29  |  8.4 KB  |  188 lines  |  [TEXT/MPS ]
  1. /*______________________________________________________________________
  2.  
  3.     utl.h - Utilities Interface.
  4.     
  5.     Copyright © 1988-1991 Northwestern University.
  6. _____________________________________________________________________*/
  7.  
  8. #ifndef __utl__
  9. #define __utl__
  10.  
  11. /* ASCII codes. */
  12.  
  13. #define homeKey                0x01        /* ascii code for home key */
  14. #define enterKey                0x03        /* ascii code for enter key */
  15. #define endKey                    0x04        /* ascii code for end key */
  16. #define helpKey                0x05        /* ascii code for help key */
  17. #define deleteKey                0x08        /* ascii code for delete key */
  18. #define tabKey                    0x09        /* ascii code for tab key */
  19. #define pageUpKey                0x0B        /* ascii code for page up key */
  20. #define pageDownKey            0x0C        /* ascii code for page down key */
  21. #define returnKey                0x0D        /* ascii code for return key */
  22. #define escapeKey                0x1B        /* ascii code for escape key */
  23. #define leftArrow                0x1C        /* ascii code for left arrow key */
  24. #define rightArrow            0x1D        /* ascii code for right arrow key */
  25. #define upArrow                0x1E        /* ascii code for up arrow key */
  26. #define downArrow                0x1F        /* ascii code for down arrow key */
  27.  
  28. /* System constants. */
  29.                                                     
  30. #define    FSFCBLen                0x3F6        /* address of low-memory global telling
  31.                                                     whether or not we have HFS 
  32.                                                     (see TN 66) */
  33. #define    FCBSPtr                0x34E        /* pointer to file control blocks */    
  34. #define    MenuList                0xA1C        /* handle to menu list */
  35.  
  36. #define    sfNoPrivs            -3993        /* rsrc id of standard file alert */
  37. #define    sfBadChar            -3994        /* rsrc id of standard file alert */
  38. #define    sfSysErr                -3995        /* rsrc id of standard file alert */
  39. #define    sfReplaceExisting    -3996        /* rsrc id of standard file alert */
  40. #define    sfDiskLocked        -3997        /* rsrc id of standard file alert */
  41.  
  42. #define    titleBarHeight        19            /* height of std doc window title bar */
  43.  
  44. #define    fInited                0x0100    /* finder flag set if file inited
  45.                                                     (bit 8 - see TN 40) */
  46. #define    fAlias                0x8000    /* finder flag set if file is an alias */
  47.  
  48. /* Type definitions. */
  49.  
  50. typedef void (*utl_ComputeStdStatePtr)(WindowPtr theWindow);
  51.  
  52. typedef void (*utl_ComputeDefStatePtr)(WindowPtr theWindow,
  53.     Rect *userState);
  54.     
  55. typedef pascal Boolean (*utl_AEIdleProcPtr)(EventRecord *theEventRecord,
  56.     long *sleepTime, RgnHandle *mouseRgn);
  57.     
  58. typedef struct popupPrivateData {        /* see IM VI p. 3-19 */
  59.     MenuHandle            mHandle;
  60.     short                    mID;
  61.     char                    mPrivate[0];
  62. } popupPrivateData;
  63.  
  64. /* Function definitions. */
  65.  
  66. extern short utl_AppendDITL (DialogPtr theDialog, short theDITLID);
  67. extern RgnHandle utl_BuildDialogIBeamRgn (DialogPtr theDialog);
  68. extern void utl_CenterDlogRect (Rect *rect, Boolean centerMain);
  69. extern void utl_CenterRect (Rect *rect);
  70. extern OSErr utl_CheckAERequiredParams (AppleEvent *event);
  71. extern Boolean utl_CheckPack (short packNum, Boolean preload);
  72. extern short utl_CheckSpecialDialogKey (DialogPtr theDialog, char theKey,
  73.     short modifiers, short defaultItem, short cancelItem);
  74. extern void utl_CopyPString (Str255 dest, Str255 source);
  75. extern Boolean utl_CouldDrag (Rect *windRect, short offset);
  76. extern OSErr utl_CountProcesses (short *count);
  77. extern void utl_DILoad (void);
  78. extern OSErr utl_DoDiskInsert (long message, short *vRefNum);
  79. extern void utl_DrawGrowIcon (WindowPtr theWindow);
  80. extern Boolean utl_Ejectable (short vRefNum);
  81. extern void utl_ErrorAlert (Str255 tmpl, short dlogID, 
  82.     ModalFilterProcPtr filterProc, Str255 p0, Str255 p1,
  83.     Str255 p2, Str255 p3);
  84. extern void utl_ErrorAlertRez (short rezID, short index, short dlogID,
  85.     ModalFilterProcPtr filterProc, 
  86.     Str255 p0, Str255 p1, Str255 p2, Str255 p3);
  87. extern void utl_FixStdFile (void);
  88. extern void utl_FlashButton (ControlHandle theButton);
  89. extern void utl_FlashDialogButton (DialogPtr theDialog, short itemNo);
  90. extern pascal void utl_FrameItem (WindowPtr theWindow, short itemNo);
  91. extern Boolean utl_GestaltFlag (OSType selector, short bitNum);
  92. extern short utl_GetApplVol (void);
  93. extern short utl_GetBlessedWDRefNum (void);
  94. extern short utl_GetDialogControlValue (DialogPtr theDialog, short itemNo);
  95. extern short utl_GetDialogEditFieldNum (DialogPtr theDialog);
  96. extern long utl_GetDialogNumericValue (DialogPtr theDialog, short itemNo);
  97. extern void utl_GetDialogPopupValue (DialogPtr theDialog, short itemNo, 
  98.     Str255 val);
  99. extern void utl_GetDialogText (DialogPtr theDialog, short itemNo, Str255 theText);
  100. extern Boolean utl_GetFontNumber (Str255 fontName, short *fontNum);
  101. extern long utl_GetLongSleep (void);
  102. extern short utl_GetMBarHeight (void);
  103. extern ControlHandle utl_GetNewControl (short controlID, 
  104.     WindowPtr theWindow);
  105. extern DialogPtr utl_GetNewDialog (short dialogID, Ptr dStorage, 
  106.     WindowPtr behind);
  107. extern WindowPtr utl_GetNewWindow (short windowID, Ptr wStorage, 
  108.     WindowPtr behind);
  109. extern long utl_GetSysDirID (void);
  110. extern short utl_GetSysVol (void);
  111. extern short utl_GetSysWD (void);
  112. extern void utl_GetWindGD (WindowPtr theWindow, GDHandle *gd, 
  113.     Rect *screenRect, Rect *windRect, Boolean *hasMB);
  114. extern long utl_GetVolFilCnt (short volRefNum);
  115. extern Boolean utl_HaveColor (void);
  116. extern Boolean utl_HaveSound (void);
  117. extern char utl_HGetState (Handle h);
  118. extern void utl_HSetState (Handle h, char flags);
  119. extern void utl_InitSpinCursor (CursHandle cursArray[], short numCurs, 
  120.     short tickInterval);
  121. extern Boolean utl_InteractionPermitted (void);
  122. extern void utl_InvalGrow (WindowPtr theWindow);
  123. extern Boolean utl_IsDAWindow (WindowPtr theWindow);
  124. extern Boolean utl_IsLaser (THPrint hPrint);
  125. extern OSErr utl_KillAllProcesses (utl_AEIdleProcPtr idleProc, Boolean *allKilled);
  126. extern OSErr utl_KillOneProcess (utl_AEIdleProcPtr idleProc,
  127.     ProcessSerialNumber *psn);
  128. extern OSErr utl_LocateFinder (Boolean *finderFound, FSSpec *finderFSpec);
  129. extern void utl_LockControls (WindowPtr theWindow);
  130. extern void utl_ModalDialog (short dlogID, ModalFilterProcPtr filterProc, 
  131.     short defaultItem, short cancelItem, 
  132.     short *itemHit, DialogPtr *theDialog, ...);
  133. extern void utl_ModalDialogContinue (ModalFilterProcPtr filterProc, 
  134.     short defaultItem, short cancelItem, short *itemHit);
  135. extern pascal void utl_OutlineDefaultButton (WindowPtr theWindow, short itemNo);
  136. extern void utl_PlotSmallIcon (Rect *theRect, Handle theHandle);
  137. extern void utl_PlugParams (Str255 line1, Str255 line2, Str255 p0, 
  138.     Str255 p1, Str255 p2, Str255 p3);
  139. extern void utl_RedrawMenuBar (Boolean mBarState[], short nMenus);
  140. extern OSErr utl_Restart (void);
  141. extern void utl_RestoreWindowPos (WindowPtr theWindow, Rect *userState, 
  142.     Boolean zoomed, short offset,
  143.     utl_ComputeStdStatePtr computeStdState,
  144.     utl_ComputeDefStatePtr computeDefState);
  145. extern OSErr utl_ReviveFinder (FSSpec *fSpec);
  146. extern Boolean utl_Rom64 (void);
  147. extern short utl_SaveChangesAlert (Str255 tmpl, short dlogID, 
  148.     ModalFilterProcPtr filterProc, Str255 p0, Str255 p1,
  149.     Str255 p2, Str255 p3);
  150. extern short utl_SaveChangesAlertRez (short rezID, short index, short dlogID,
  151.     ModalFilterProcPtr filterProc, 
  152.     Str255 p0, Str255 p1, Str255 p2, Str255 p3);
  153. extern void utl_SaveWindowPos (WindowPtr theWindow, Rect *userState, 
  154.     Boolean *zoomed);
  155. extern short utl_ScaleFontSize (short theFontNum, short theFontSize, 
  156.     short percent, Boolean laser);
  157. extern void utl_SetDialogControlValue (DialogPtr theDialog, short itemNo, 
  158.     short val);
  159. extern void utl_SetDialogNumericText (DialogPtr theDialog, short itemNo, 
  160.     short theNum);
  161. extern void utl_SetDialogPopupValue (DialogPtr theDialog, short itemNo,
  162.     Str255 val, short defaultVal);
  163. extern void utl_SetDialogText (DialogPtr theDialog, short itemNo, 
  164.     Str255 theText);
  165. extern void utl_SetDialogUserItem (DialogPtr theDialog, short itemNo, 
  166.     Handle userItem);
  167. extern void utl_SpinCursor (void);
  168. extern void utl_StaggerWindow (Rect *windRect, short initialOffset, short offset, 
  169.     Point *pos);
  170. extern Boolean utl_StandardAsciiChar (char c);
  171. extern short utl_StopAlert (short alertID, 
  172.     ModalFilterProcPtr filterProc, short cancelItem);
  173. extern void utl_SwitchDialogRadioButton (DialogPtr theDialog, short itemNo,
  174.     short first, short last);
  175. extern Boolean utl_SysHasNotMgr (void);
  176. extern Boolean utl_SysHasPopUp (void);
  177. extern short utl_TellMeTwiceAlert (Str255 tmpl, short dlogID, 
  178.     ModalFilterProcPtr filterProc, Str255 p0, Str255 p1,
  179.     Str255 p2, Str255 p3);
  180. extern short utl_TellMeTwiceAlertRez (short rezID, short index, short dlogID,
  181.     ModalFilterProcPtr filterProc, 
  182.     Str255 p0, Str255 p1, Str255 p2, Str255 p3);
  183. extern short utl_ToggleDialogCheckBox (DialogPtr theDialog, short itemNo);
  184. extern Boolean utl_VolIsMFS (short vRefNum);
  185. extern Boolean utl_WaitNextEvent (short eventMask, EventRecord *theEvent,
  186.     long sleep, RgnHandle mouseRgn);
  187.  
  188. #endif